home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / XAMPP 1.4.14 / xampp-win32-1.4.14-installer.exe / xampp / php / pear / docs / TCLink / README < prev   
Text File  |  2004-03-24  |  3KB  |  91 lines
  1.  
  2.  
  3.                                 TCLink v3.4
  4.                              PHP Implementation
  5.                        copyright (C) TrustCommerce 2003
  6.                          http://www.trustcommerce.com
  7.                          developer@trustcommerce.com
  8.  
  9.                               September 5, 2003
  10.  
  11. I. DESCRIPTION
  12.  
  13.   TCLink is a thin client library to allow your e-commerce servers to
  14. connect to the TrustCommerce payment gateway easily and consistently.
  15. The protocol (which is the same across all platforms and languages) is
  16. well-documented in the Web Developer's Guide, so please consult it for
  17. any questions you may have about the protocol syntax itself.
  18.  
  19.   If you are using Python on Win32, do not use this client.  Please
  20. download the COM object from the Vault website instead.
  21.  
  22.   TCLink was originally ported to PHP by Andrew Barnett of Data Clarity.
  23. Thanks go to both him (for the code) and his business (for their support
  24. of open source).
  25.  
  26.  
  27. II. LICENSE
  28.  
  29.   TCLink for PHP is released under the GNU LGPL.  Please read LICENSE
  30. for details.
  31.  
  32.  
  33. III. REQUIREMENTS
  34.  
  35.   You must be running PHP 4.0.4pl1 or higher.
  36.  
  37.   You need to have the OpenSSL development libraries installed.  Versions
  38. prior to 0.9.6 may work, but are not supported; it is recommended you use
  39. the most recent version.
  40.  
  41.   Besides the normal PHP install, you'll need the php-devel package,
  42. which contains files needed for building PHP modules.  You can tell
  43. if this package is installed if the binary "phpize" is in your path.
  44.  
  45.  
  46. IV. BUILDING
  47.  
  48.   At the root directory of this archive, execute the following:
  49.  
  50.     ./build.sh
  51.  
  52.   If the module builds without errors, test it with this command:
  53.  
  54.     php tctest.php
  55.  
  56.   This script will run a test transaction and print the results.
  57.  
  58.  
  59. V. INSTALLATION
  60.  
  61.   If you have root access to the machine, you will probably want to
  62. install TCLink as a global extension.  You can do this by copying the
  63. module library (modules/tclink.so) to your PHP extensions directory
  64. (typically /usr/lib/php4).  Your extensions directory is defined by the
  65. "extension_dir" directive in php.ini.
  66.  
  67.   Edit php.ini (typically found in /etc) and add the following line:
  68.  
  69.     extension=tclink.so
  70.  
  71.   Restart your webserver, and all PHP scripts will have access to TCLink.
  72.  
  73.   If you can't or don't want to install the module system wide, you can
  74. still load it manually in each script that needs to access it through
  75. the dl() call.  See the top of tctest.php for an example.
  76.  
  77.  
  78. VI. USAGE
  79.  
  80.   The tctest.php script shows a simple example of running transactions
  81. through the TCLink API.  A more complex example is contained in
  82. tcexample.php.  For further information, please consult the TC
  83. Developer's Guide, located in the doc subdirectory.
  84.  
  85.   A note to users of TCLink PHP prior to 3.3: the API has changed from
  86. the C-style interface, to a single tclink_send() function which accepts
  87. a hash (associative array) of input parameters, and returns a hash with
  88. the output parameters.  Please see the examples to update your code.
  89.  
  90.  
  91.